home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / mods / players / hip140.lha / HippoPlayer.doc < prev   
Encoding:
Text File  |  1994-01-19  |  29.6 KB  |  913 lines

  1. ******************************************************************************
  2.                             --- HippoPlayer ---
  3.                  Programmed by K-P Koljonen
  4.              (Moonstone / Hippopotamus Design)
  5.  
  6.                    This program may be freely distributed
  7.                 as long as all files are included unaltered! 
  8.                       Not for commercial use without
  9.                        a permission from the author.
  10.             Copyright © 1994-1995 K-P Koljonen
  11.                               ** FREEWARE **
  12. ******************************************************************************
  13.  
  14.  
  15. HippoPlayer  (HiP)  is  a multiformat moduleplayer for the Amiga.  It works
  16. perfectly  under  Kickstart  1.2 and has about all the same features as the
  17. Multiplayer, which is Kick2.0+ only.  One main reason why I bothered myself
  18. by  making  this  program  was  that  there were no good Kick1.3 compatible
  19. players around, or I didn't know of one.  The other reason was that my good
  20. friend Jarno Paananen (Guru/Sahara Surfers) made a replayroutine for Scream
  21. Tracker ]I[ modules.
  22.  
  23. If  you  want  to play n+1 (a lot) different moduleformats, this program is
  24. not for you.
  25.  
  26. The  aim  was  to  make  a  good  moduleplayer  that  works  on every Amiga
  27. configuration  and has all the features as the kickstart 2.0+ moduleplayers
  28. have.   To  achieve  speed,  little  size  and  memory  usage,  HiP is 100%
  29. assembler.
  30.  
  31. HiP  has  a good support for Scream Tracker ]I[, FastTracker, TakeTracker,
  32. and  MultiTracker  modules,  meaning  that you can listen them with a 68000
  33. Amiga  with  listenable  quality.  All are played by the famous replayer by
  34. Guru.  HiP was the second program to use the PS3M routines after Guru's own
  35. player.
  36.  
  37.  
  38.  Some features:
  39.  · Scream Tracker ]I[, FastTracker, TakeTracker, MultiTracker, 1 to 32ch.
  40.  · SID emulation by Håkan Sundell & Ron Birk.
  41.  · TFMX modules, normal and the seven channel-ones.
  42.  · Oktalyzer modules.
  43.  · A handful of other 4 channel sample & synth music formats.
  44.  · Easy to use, nice 3D interface.
  45.  · Keyboard control.
  46.  · AppWindow.
  47.  · Moduleprograms.
  48.  · Internal multitasking.
  49.  · Loads and decompresses XPK, FImp, PowerPacker, LhA, Zip and Gzip files.
  50.  · Tested on following configurations:
  51.      A500/000, kick 1.2        (my first Amiga (nowadays little brother's))
  52.      A500/010, kick 1.3/3.1    (v1.00-v1.25 programming environment)
  53.      A1200/020, kick 3.0    (v1.27-...)
  54.      A1200/030, kick 3.0
  55.      A2000/040, kick 2.0
  56.      A3000/030, kick 3.1
  57.      A4000/040, kick 3.1 
  58.  
  59.  
  60.  
  61.  
  62. ******************************************************************************
  63. *                           *** Requirements ***                     *
  64. ******************************************************************************
  65. Any  Amiga  with some memory and Kickstart 1.2 or higher.  Reqtools.library
  66. of  any  version  will  be  needed  for  the  requesters.  There is kick1.3
  67. reqtools.library included in the archive.
  68.  
  69. In order to...             you need...
  70. ------------------------------------------------------------------
  71. Load XPK files            xpkmaster.library and some sublibs
  72. Load PowerPacker files        powerpacker.library
  73. Load lha, zip and gzip files    to look at 'Archivers'
  74. Play SID files            PlaySID.library
  75. Play 4ch MED modules        medplayer.library v2+
  76. Play 5-8ch MED modules        octaplayer.library v2+
  77.  
  78. All libraries must be copied into Libs: drawer.
  79.  
  80. reqtools.library and powerpacker.library by Nico François.
  81. xpkmaster.library by Urban Dominik Müller (?).
  82. PlaySID.library by Per Håkan Sundell & Ron Birk.
  83. medplayer.library and octaplayer.library by Teijo Kinnunen.
  84.  
  85. Font
  86. ----
  87. HiP  will  use  pearl 8 font if it is already in memory (it won't be loaded
  88. from disk), otherwise topaz 8 is used.
  89.  
  90.  
  91.  
  92.  
  93. ******************************************************************************
  94. *                           *** Music formats ***                     *
  95. ******************************************************************************
  96. Here's a list of the music formats HippoPlayer can play and what functions
  97. they support. Also the authors of the replayers are listed.
  98.  
  99. Stop/Continue    = 1 - The music can be stopped and continued.
  100. Multiple songs   = 2 - Modules can have more than one song.
  101. Volume         = 3 - Volume can be controlled.
  102. End detect     = 4 - Songend can be detected.
  103. Forward/backward = 5 - You can jump forwards and backwards in the song.
  104.  
  105. Replayer            12345    Author
  106. --------------------------------------------------------------------
  107. BP SoundMon v2.0        x-xxx    Brian Postma
  108. Delta Music v2.0        x-x--    Bent Nielsen
  109. Fred                xx---    Frederic Hahn & JC
  110. Future Composer v1.0-v1.4    x-xx-    SuperSero (of the Superions)
  111. JamCracker            x----    M. Gemmel
  112. MED 4-8ch            x----    Teijo Kinnunen
  113. Music Assembler            x-x--    Oscar Giesen & Marco Swagerman
  114. Oktalyzer 8ch            --x--    Armin Sander
  115. ProTracker            xxxxx    K-P Koljonen
  116. S3M/FTM/MOD/MTM            x-xxx    Jarno Paananen
  117. SID                xx--x    Håkan Sundell & Ron Birk
  118. SIDMon v1.0            x----    Reiner van Vliet
  119. Sonic Arranger            -x---    Carsten Schlote
  120. TFMX                xxxxx    Chris Hülsbeck
  121. TFMX 7ch            xxxxx    Chris Hülsbeck & Jochen Hippel
  122. The Player v6.1a        x-x--    Jarno Paananen
  123.  
  124.  
  125.  
  126.  
  127. Loading files
  128. -------------
  129. Normally   all   modules   will   be   loaded   in  CHIP.   Oktalyzer-  and
  130. S3M/FTM/MOD/MTM  modules  and  TFMX  songdata will be loaded in FAST RAM if
  131. possible. 
  132. All  compressed  files  will  normally  be  loaded  in CHIP.  However, it's
  133. possible  to uncompress some kilobytes from the beginning of an XPKed file,
  134. and  check if it is a S3M/FTM/MOD/MTM-, or PT module, which is to be played
  135. from FAST RAM (with PS3M), or TFMX music data (got that?).
  136.  
  137. Advantages of loading to FAST:
  138.     FAST RAM is much faster than CHIP, so mixing can be done faster.
  139.     CHIP RAM is saved if the module can or should be loaded in FAST.
  140.  
  141. LhA,  Zip  and  Gzip  files  can  be  checked and will be loaded in fast if
  142. necessary.
  143.  
  144.  
  145.  
  146.  
  147. ProTracker
  148. -----------
  149. The most popular music format on the Amiga. 
  150. HiP  features my own ProTracker playroutine.  On a plain A500 it uses max 6
  151. rasterlines in most modules (faster than ProRunner).
  152.  
  153. - Fastram player
  154.  · Plays modules from fast ram
  155.  · Uses 4x65kb for buffers. 
  156.  · Doesn't play looped samples with 900 command correctly.
  157.  · Doesn't play C-201000 combinations correctly.
  158.                 ---02000
  159.  · May have some other bugs too.
  160.  · Is VERY fast.
  161.  
  162. - Multisong modules
  163. There  are  some  modules  around  with  several  songs  separated by the B
  164. command.  HiP allows you to play these kind of modules correctly.  Just use
  165. the  'PS'  and  'NS'  gadgets  (or the respective keys) to select different
  166. songs.
  167.  
  168.  
  169.  
  170.  
  171. TFMX
  172. ----
  173. HiP  can  play  both  4 and 7 channel TFMX modules, including the excellent
  174. Turrican  2  and 3 intro tunes.  A TFMX module consists of two files.  They
  175. must   be   named   'mdat.<name>'   and  'smpl.<name>'.   To  play,  select
  176. 'mdat.<name>'.  HippoPlayer will then try to load the 'smpl.<name>' file.
  177.  
  178. The  mixing  rate  of  TFMX  7 channel replayer can be changed.  The bigger
  179. value,  the  better  quality  and  bigger  CPU  load.   I have noticed that
  180. mixingrates 21kHz and 22kHz give somewhat strange results, so I use 20kHz.
  181.  
  182.  
  183.  
  184.  
  185. S3M/FTM/MOD/MTM
  186. ---------------
  187. PS3M the replayer
  188. (ScreamTracker ]I[, ProTracker, FastTracker, TakeTracker, MultiTracker)
  189.  
  190. Jarno  Paananen  (Guru/Sahara Surfers) has made replayers for these.  It is
  191. able  to  play  1-32  voices  simultaneously  by  mixing  them through four
  192. channels.   The  mixing  routine  is  amazingly  fast,  even on Amiga 500 8
  193. channel  modules  are very listenable.  The replayer gobbles quite a bit of
  194. memory for it's buffers, so don't be surprised.
  195.  
  196. Mixing  rates  can be changed.  Again, the bigger value, the better quality
  197. and  bigger CPU load.  Using the system friendly mode on A500 will probably
  198. more  or less jam the machine, therefore you should use the killer mode for
  199. the best quality.
  200.  
  201. PS3M  allows mixing rates higher than 28kHz, which is normally the hardware
  202. limit.   In some AGA screenmodes (dblPAL, dblNTSC, atleast) mixingrates can
  203. be upto 56kHz high.  Ofcoz, this doesn't work under OCS/ECS Amigas.
  204.  
  205. These modules can and should be played from FAST RAM.
  206.  
  207. PS3M playingmodes
  208. - - - - - - - - -
  209. Mono        Play all channels on both sides.
  210. Stereo        Normal.
  211. Surround    Play some of the right side on the left and vice versa.
  212. Real Surround    About the same, but uses more memory.
  213. 14-bit stereo    BEST QUALITY, biggest CPU load, largest memory usage and
  214.         lowest volume level.
  215.  
  216.  
  217.  
  218. SID
  219. ---
  220. These are tunes ripped from C64 games & demos.  Both normal file + icon and
  221. one  file formats are supported.  The playing is done by PlaySID.library by
  222. Håkan Sundell and Ron Birk.  Great job dudes!
  223.  
  224. NOTE:  Snapped from the docs of PlaySID v3.0:
  225. "This  utility is designed to work with true multitasking, under any system
  226. version and any amiga model."
  227.  
  228. I must be deaf.  I heard nothing when I tried to play under kick1.3.
  229.  
  230.  
  231.  
  232.  
  233. ******************************************************************************
  234. *                             *** Gadgets ****                               *
  235. ******************************************************************************
  236.  
  237.  Keyboard shortcuts are bracketed. 
  238.  
  239.  New    Clear the modulelist, select new modules and play the first one.
  240.  
  241.  Play    Load and/or play selected module. If nothing selected, pop up
  242.     the filerequester. [RETURN]
  243.  
  244.  Cont    Continue playing after stop.
  245.  
  246.  Stop    Stop playing.
  247.  
  248.  Eject    Stop playing and free current module. [TAB]
  249.  
  250.  Prev    Load and play previous module.
  251.  
  252.  Next    Load and play next module.
  253.  
  254.  PS    Play previous song. [ARROW LEFT]
  255.  
  256.  NS    Play next song. [ARROW RIGHT]
  257.  
  258.  <    Backward, jump to previous pattern. [,]
  259.  
  260.  >    Forward, jump to next pattern. [.]
  261.  
  262.  Prefs  Pop up the prefs window. You can also close it with this button.
  263.  
  264.  Horizontal propgadget
  265.     Volume controller. [B][N]
  266.  
  267.  The leftmost propgadget
  268.     Scroll modulelist.
  269.  
  270.  Add    Add modules to the end of the list, pop up the filerequester. [A]
  271.  
  272.  Del    Delete selected module from the list. [BACKSPACE]
  273.  
  274.  Clr    Clear the list. [D]
  275.  
  276.  LoP    Load moduleprogram.
  277.  
  278.  SaP    Save moduleprogram.
  279.  
  280.  ?    Enter the infowindow. [HELP]
  281.       Samplenames  Displays samplenames of MODs, S3Ms, FTMs and
  282.                MTMs.
  283.       SID info     Information about SID modules.
  284.  
  285.                Samplenames or SID info can also be invoked by
  286.                pressing left mousebutton on the leftmost third
  287.                        of the name/type box or the 'I' key. (When there's
  288.                        no info available the infowindow will be opened.)
  289.  
  290.       Help           Description of gadgets & keyboard shortcuts.
  291.       About           About HiP...
  292.        Exit           Hmm..
  293.  
  294.  Windowclose-button [ESC]
  295.     Close all windows except requesters and exit.
  296.  
  297.  ** Other keys **
  298.  ARROW UP    Select previous module.
  299.  ARROW DOWN    Select next module.
  300.  SPACE        Toggle play/stop.
  301.  *, (next to RETURN) Randomize and play a module.
  302.  7,8,9,0    Show: time-pos/len-songnumber, clock, free memory, modulename.
  303.  F1-F10        Load & play a module or a moduleprorgram.
  304.  CTRL        Shrink/expand window.
  305.  
  306.  
  307. Filebox
  308. -------
  309. Here  you  can see the modulelist.  You can select a module by pressing the
  310. left mousebutton on it or by pressing arrows up and down.
  311.  
  312.  
  313.  
  314. Right mousebutton
  315. -----------------
  316. Pressing the right mousebutton or the control key will shrink the window so
  317. that  only the titlebar will be shown.  Press again on the activated window
  318. to expand.
  319. If  you  somehow  lose  the  window, just load the program again.  If there
  320. already  was  one  HippoPlayer running, it's window will be popped to front
  321. and expanded.
  322.  
  323.  
  324.  
  325.  
  326. ******************************************************************************
  327. *                              *** Prefs ****                     *
  328. ******************************************************************************
  329. Here you can configure HippoPlayer by using the gadgets & buttons.  You can
  330. invoke  a  multiple  choice  requester by pressing right mousebutton on the
  331. following gadgets:
  332.     · Play
  333.     · Show
  334.     · PS3M mode 2
  335.     · Type of scope
  336.  
  337.  
  338. Play
  339. ----
  340.  List repeatedly    Play modulelist over and over.
  341.  List once        Play list once stop.
  342.  Module repeatedly    Play one module over and over.
  343.  Module once        Play one module once and stop.
  344.  Modules in random order
  345.         Play modules in random order.
  346.         When playing has started, same module will not be played twice
  347.                 unless all modules have been played first.
  348.              
  349. 'Play'  affects  the  replayers  where  the end of the song can be detected
  350. from.
  351.  
  352.  
  353.  
  354. Show (titlebar information)
  355. ----
  356.  Time, pos/len, song    Show playing time, songposition/length and
  357.             songnumber/maxsong (#n/n) depending of what kind
  358.             of a module is being played.
  359.  Clock            Show clock (24h).
  360.  Free memory        Show free chip and fast in kilobytes.
  361.  
  362.  
  363.  
  364. Filter control
  365. --------------
  366. Filter controlled by module, filter forced off or on.
  367.  
  368.  
  369.  
  370. XPK identify
  371. ------------
  372. When  on, all XPKed files will be checked if they should be loaded in FAST.
  373.  
  374.  
  375.  
  376. Fade volume
  377. -----------
  378. This  will  cause  those replayers that support volume to fade music in and
  379. out.
  380.  
  381.  
  382.  
  383. Module directory
  384. ----------------
  385. Here you can enter your module directory or select it by pressing '?'.
  386.  
  387.  
  388.  
  389. ProTracker tempo
  390. ----------------
  391. Enable  or  disable  Protracker tempo command.  Use on old modules that use
  392. speeds higher than $1F.
  393.  
  394.  
  395.  
  396. PT replayer
  397. -----------
  398. Normal:  Use normal Protracker replayer to play modules from CHIP RAM.
  399. Fastram: Play PT modules from FASTram.
  400. PS3M:     Use Guru's PS3M to play modules from CHIP or FAST.
  401.      This way you can use those neat modes, eg listen ProTracker
  402.      modules with real surround.
  403.  
  404.  
  405.  
  406. Scopes
  407. ------
  408. Select  one of the seven scopes by clicking the gadget.  The 'Scope on/off'
  409. button  will  start it up.  You can close a scope by closing it's window or
  410. clicking the gadget again.
  411.  
  412. These are for ProTracker-modules only:
  413.  
  414. Quadrascope (& bars)
  415.  -  This  is  just  like  the  one in Protracker.  Channel order:  1,2,3,4.
  416. Hipposcope (& bars)
  417.  - Couldn't invent a better name.. Bass-sounds look nice with this one.
  418.    Channel order: 1,2,3,4.
  419. Frequency analyzer (& bars)
  420.  - This one's more processor intensive.  There is one for the left and the
  421.    right side. It is supposed to display frequencies while not using
  422.    period values. This is not FFT, but is based on Guru's strange idea...
  423.    Bass-sounds are on the left and treblesounds on the right.
  424.    Bar channel order: 1,4,2,3.
  425. Patternscope
  426.  - ProTracker-emulator... Shows patterndata, four fake VU-meters and four
  427.    tiny periodboxes.
  428.    Channels: 1,2,3,4.
  429. Bars
  430.  - These will try to visualize the volume and the period of each channel.
  431.    The vertical position represents sampleperiod and the width samplevolume.   
  432.  
  433. There  are  almost  the  same  scopes  for PS3M:  Quadrascope (stereoscope,
  434. actually), hipposcope and frequency analyzer.  No bars.
  435.  
  436. The  scopes  will  need some kilobytes of memory for buffers.  They are run
  437. with priority of -30 so that they won't interfere with anything important.
  438.  
  439.  
  440.  
  441. TFMX rate
  442. ---------
  443. Mixingrate for the 7 channel TFMX replayer.  Rates 21kHz and 22kHz may give
  444. strange results, so the best rate is 20kHz.
  445.  
  446.  
  447. Timeout
  448. -------
  449. Set  playing  time.   Useful  for  "scanning"  modules  and for neverending
  450. SID-tunes.  Disabled in the leftmost position.
  451.  
  452.  
  453. PS3M settings
  454. -------------
  455. This replayer can play S3Ms, FTMs, MODs and MTMs.
  456.  
  457. Mode 1:    System - Allow multitasking when playing.
  458.     Killer - Disable system and stop almost all DMA to get the best
  459.                  quality. The blue flickering represents free CPU time.
  460.          Stop playing by pressing mousebuttons.
  461.  
  462. Mode 2: Playingmodes (see the PS3M doc).
  463.  
  464. Volumeboost:
  465.     Makes the sound clearer and louder (use when 8 or more channels)
  466.  
  467. Mrate (mixingrate):
  468.     Mixingrate in kHz.
  469.  
  470.  
  471.  
  472. Archivers (top right corner)
  473. ---------
  474. HiP can decompress and play LhA, Zip and Gzip files.  You need to specify a
  475. path, a command and options for each.
  476.  
  477. LhA,  Zip  and  Gip archives will be extracted into a file right after '>'
  478. (output  redirection).   The %s means the name of the archive to be opened.
  479. The  output  file  can  be placed somewhere else than in RAM:  if you don't
  480. have enough memory.
  481.  
  482. You need: LhA, UnZip or Gzip, according to what kind of packed files you have
  483.       (be sure they really are where you defined them to be),
  484.       and 'Run' command in C:.
  485.  
  486. These  kind  of  files are identified by checking the name.  LhA files have
  487. suffix '.lzh' or '.lha', zip files '.zip', and gzip files '.z' or '.gz'.
  488.  
  489. ** Hint **
  490. - Archived files may be packed with XPK, FImp or Powerpacker.  For example,
  491. you  could  use  xpkDLTA  to encipher a module and then LhA it.  Gives very
  492. good compression of sound related data.
  493.  
  494. ** Anther hint **
  495. -  You  can  store  both TFMX mdat.  and smpl.  files in one archive!  Just
  496. remember that the files MUST BE unpacked before archiving.
  497.  
  498.  
  499. Archiver commands
  500. -----------------
  501.  
  502. LhA -> c:lha >RAM:virtahepo p -qMNIQw "%s"
  503. °°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°
  504. c:lha        program lha and complete path
  505. >RAM:virtahepo    A file where decompressed data will be stored.
  506.         Can be placed for example on HD (>dh1:temp/rhinocerus)
  507. p        Print files to stdout, in other words in file after the '>'.
  508. -qMNIQw        q    be quiet
  509.         M    no autoshow files
  510.         N    no progress indicator
  511.         I    ignore LHAOPTs variable
  512.         Qw    disable wildcards
  513. "%s"        The %s will be replaced with archivename.
  514.  
  515. Zip -> C:unzip >RAM:virtahepo -cqq "%s"
  516. °°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°
  517. -cqq    c    extract files to stdout.
  518.     qq    be very quiet
  519.  
  520. Gzip -> c:gzip >RAM:virtahepo -cdq "%s"
  521. °°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°
  522. -cdq    c    write to stdout, keep original files unchanged
  523.     d    decompress
  524.     q    be quiet
  525.     
  526. You can also use other programs for uncompressing.
  527. Example:    LhA -> c:lhx >RAM:virtahepo p -qMNQw "%s"
  528.  
  529. Gzip  note:   Being a UNIX program, Gzip will need a considerable amount of
  530. stack  for  not crashing.  You should set the size of the stack with 'stack
  531. <stacksize>' command.  Something like 20000-50000 should be ok.
  532.  
  533.  
  534.  
  535. Doubleclick
  536. -----------
  537. When enabled, a module can be played by doubleclicking on it.
  538.  
  539.  
  540.  
  541. Center name
  542. -----------
  543. When enabled, chosen module will be centered in the filebox.
  544.  
  545.  
  546.  
  547. Priority
  548. --------
  549. Select the mainprogram priority:  -1, 0, +1.
  550.  
  551.  
  552.  
  553. Filebox
  554. -------
  555. Define  the  number  of  files  showed  simultaneously  in the main window.
  556. Minimum  is  3 and maximum is 50 (will need a BIG screen).  If the value is
  557. too  big  for the current screen, it will be truncated.  The more names the
  558. slower update speed.
  559.  
  560.  
  561.  
  562. Startup
  563. -------
  564. When enabled, HiP will start playing immediately on startup.  The module or
  565. the program to be played can be chosen by clicking the 'Startup' gadget.
  566.  
  567.  
  568.  
  569. Function keys
  570. -------------
  571. You  can  install a module or a moduleprogram for each of the function keys
  572. (F1-F10)  by  clicking  this  gadget.   Then  when  you  press  a fkey, the
  573. corresponding moduleprogram or module will be loaded and played.
  574.  
  575.  
  576. Save, Use, Cancel
  577. -----------------
  578. I  guess  you can guess these.  If you close the prefs window, it's same as
  579. 'Cancel'ling.  The prefs-file will be saved in the S:  directory.
  580.  
  581.  
  582.  
  583.  
  584.  
  585. ******************************************************************************
  586. *                         *** Commandline options ***                  *
  587. ******************************************************************************
  588. You can add modules or load a moduleprogram with commandline options.
  589.  
  590. Add modules to the list:
  591.  
  592. HiP  <file2> <file2> ... <file16>
  593.  
  594. All  the  files will be added to the list and the first one will be played.
  595. Existing list will be cleared.
  596.  
  597. Load a moduleprogram:
  598.  
  599. HiP PRG <moduleprogram>
  600.  
  601. The  program  will  be  loaded and the first module will be played.  If the
  602. playmode  is set as 'Modules in random order', then a random module will be
  603. picked  and  played.   Existing  list  will  be  cleared.   (The PRG is not
  604. necessary, but recommended.)
  605.  
  606. All filenames must be entered with full paths!
  607.  
  608. **** NOTE THIS:  You can also do these things while HiP is ALREADY running!
  609. This  allows you to use HiP as a commandline moduleplayer.  Eg in Directory
  610. Opus it makes a good play button.
  611.  
  612.  
  613.  
  614.  
  615. ***********
  616. * History *
  617. ***********
  618. Read this!  Some things are not mentioned elsewhere!
  619.  
  620.  
  621. v1.00    Works...
  622.     I couldn't check the bug I suspected because a friend of
  623.         mine wanted to upload the program everywhere. This bug causes
  624.     memory to get fragmented when loading XPK files.
  625.  
  626. v1.01    No major bugs left..
  627.  
  628. v1.10   · Removed some small bugs here and there.
  629.     · A description of the gadgets in the program.
  630.     · Support for multisong Protracker modules.
  631.         · Replayer which plays S3M/FTM/MOD/MTM modules, by Guru (jee).
  632.     · Load/save moduleprogram.
  633.     · Commandline options.
  634.     · Four scopes.
  635.     · Communication between most of HiP's processes. All windows except
  636.           reqtools requesters will be closed when the mainwindow is closed.
  637.     · Window positions will be saved in the prefs-file. Also the state
  638.       of the scope (on/off) will be saved.
  639.     · Doesn't interfere with serial transfers on slower Amigas anymore.
  640.           Exceptions are MED, TFMX, The Player.
  641.           They use their own way of timing (level 6 here I come).
  642.         · Works correctly on both PAL and NTSC.
  643.     · Behaves more intelligently with bigger fonts, eh...
  644.     · If playingmode is 'Random', Next/Prev will randomize a new
  645.       module instead of what they would normally do.
  646.     · Removed a bug in ProTracker's arpeggio.
  647.     · Newlook propgadgets on Kickstarts 2.0+.
  648.     · FutureComposer end-detect.
  649.  
  650. v1.11    · Now should work on 50/60/72Hz screens correctly.
  651.     · New icon (less eyesore?).
  652.     · Filter control in Prefs.
  653.     · Doesn't try to open windows over screen's borders.
  654.     · Info window, in which an option to show samplenames.
  655.     · TFMX channel autodetect.
  656.     · New PS3M -> Mixingrate: 5-56 kHz, volumeboost: 0-8
  657.     · Lotsa fixes'n stuff.
  658.  
  659. v1.12 (19.7.1994)
  660. -----------------
  661.     · Fixes'n stuff part 2.
  662.     · New scope: Frequency analyzer
  663.     · More stuff in info window.
  664.     · New formats: The Holy Noise, MED 5-8 channels.
  665.     · Executable size (and memory usage) reduced.
  666.       Achieved this by packing nearly all the replayers.
  667.     · Removed a bug that caused PT vibratos to disappear. This bug
  668.       was created when I removed the arpeggio-bug. Hmm..
  669.     · More informative loading phase.
  670.     · Enables/disables gadgets according to current replayer.
  671.     · New prefs design.
  672.     · Modulebox can now contain 8 names.
  673.     · Titlebar information printed with SetWindowTitles().
  674.     · PT modules can be played from FAST RAM.
  675.     · End-detect: JamCracker, Oktalyzer, SoundMon v2.0.
  676.  
  677. v1.14 (30.7.1994)
  678. -----------------
  679.     · Fixed a bug in 'del' (caused a crash sometimes).
  680.     · Almost full keyboard control.
  681.     · New formats: Delta Music v2.0, Sonic Arranger.
  682.     · Some enchancements in the filebox and in the slider.
  683.     · PS3M now frees ALL buffers needed for playing.
  684.     · LhA, Zip & Gzip compatibility.
  685.     · Added a clock (titlebar info).
  686.  
  687. v1.15 (5.8.1994)
  688. ----------------
  689.     · A couple of fixes here and there.
  690.     · Next/prev working fine again.
  691.     · Added a key for random play.
  692.  
  693. v1.16 (12.8.1994)
  694. -----------------
  695.     · LhA/Zip/Gzip filehandling much better.
  696.     · A bug in samplenamesroutine fixed.
  697.     · PS3M priority reduced from 2 to 0.  
  698.     · PS3M system friendly mode end-detect (S3M, FTM, MOD, MTM).
  699.     · Show free memory in titlebar.
  700.     · SoundMon v2.0 bug fixed.
  701.     · Stringgadgets' fontbug corrected (hopefully).
  702.     · Volumeboost controlled with propgadget.
  703.     · Scope priority from -5 to -30.
  704.     · Priority selector in prefs (for mainprogram).
  705.     · Startup errormessages.
  706.     · Memory usage reduced 5kb compared to v1.15
  707.  
  708. v1.17 (?.8.1994)
  709. ----------------
  710.     · Some fixes.
  711.     · Numerous bugs seemed to appear in v1.16. Hunt in progress..
  712.       Removed one in TFMX 7ch interface.
  713.       SoundMon v2.0 bug removed (again, was not fixed in v1.16).
  714.  
  715. v1.18 (22.8.1994)
  716. -----------------
  717.     · Bughunt continues.
  718.       Several removed and among them one that possibly scrambled memory.
  719.     · Non-existent doublebuffering changed to fade volume.
  720.  
  721. v1.19 (?.?.1994)
  722. ----------------
  723.     · No volume fading when tune ends while using randomplay.
  724.     · PS3M priority changed again, this time to +1.
  725.     · Windowcoloring.
  726.     · PT replayer still had bugs left: vibrato & tremolo were too
  727.       strong! Fixed.
  728.     · No more H.P.Lovecraft.
  729.  
  730. v1.20 (2.9.1994)
  731. ----------------
  732.     · LhA/Zip/Gzip enchanced and some bugs removed.
  733.     · New backround color looked wrong on 8+ color screens. Fixd.
  734.     
  735. v1.23 (?.9.1994)
  736. ----------------
  737.     · SID support! Now you can listen all those cool C64 tunes!
  738.     · Samplenames => Moduleinfo. Now also info about SID modules.
  739.     · Open moduleinfo window also by pressing left mousebutton on the
  740.       name/type box or pressing 'I'.
  741.  
  742. v1.25 (13.9.1994)
  743. -----------------
  744.     · Major changes in LhA/Zip/Gzip interface. Should work OK, finally.
  745.       The version in v1.15 onwards really acted strange!
  746.     · Stereoscope for PS3M, might not work very well though.
  747.  
  748. v1.28 (21.10.1994)
  749. ------------------
  750.     · The timer will wrap properly now.
  751.     · All replayers excluding PT and PS3M didn't work on 68040 because
  752.       of the copyback-cache. Should work OK now.
  753.     · Timer and pos/len are now shown at the same time.
  754.     · Moduleinfo reorganized. All PT samplenames in same window.
  755.  
  756. v1.30 (7.11.1994)
  757. -----------------
  758.     · Fixed a very silly bug (changed the volume depending on the size
  759.       of the module being played!).
  760.     · New scope: SID.
  761.     · Improved Shell interface. Allows HiP to be more a commandline
  762.       moduleplayer.
  763.     · Time, pos/len and song number shown at the same time.
  764.     · The timer uses DateStamp().
  765.     · Requesters use the same font as the mainprogram.
  766.     · Some gfx bugs fixed.
  767.     · NEW VERSION OF THE PS3M! Mixingroutines for 68000 and 68020++. 
  768.       Faster and more beautiful! Stop/cont/fastforward/rewind etc.
  769.     · Two more scopes for PS3M.
  770.     · Removed The Holy Noise.
  771.     · The Player version increased to v6.1A.
  772.     · When a module jumps backwards it is considered ended. Works with
  773.           PS3M and ProTracker.
  774.  
  775. v1.31 (12.11.1994)
  776. ------------------
  777.     · Several not so serious bugs fixed.
  778.     · After playing TFMX 7c tunes, programs using lev4 interrupt crashed
  779.       (like PS3M). Fixed.
  780.     · Some Prefs-window reorganization.
  781.     · Hippoicon by Tommi Lindström (Hawk/Hippopotamus Design).
  782.         
  783. v1.32 (18.11.1994)
  784. ------------------
  785.     · Pressing "Play" on the module currently being played caused
  786.        HiP to load next module (in list-playmodes).
  787.     · Moduleprogram directory saved in the prefsfile.
  788.     · Samplenameviewer works OK, no more garbage.
  789.     · Some PS3M bugs removed (stop-eject=no guru).
  790.     · ProTracker replayer can cope with a bit mutated modules too.
  791.  
  792. v1.33 (7.12.-94)
  793. ----------------
  794.     · Unofficial release...
  795.  
  796. v1.34 (11.12.-94)
  797. -----------------
  798.     · Numerous fixes here and there.
  799.     · BPSoundMon enchancements: position/length, ffwd and rew, volume.
  800.     · More info in the infowindow.
  801.     · Number of subsongs checked: TFMX, TFMX 7c, Fred.
  802.     · When there's no "moduleinfo" available and the left mousebutton is
  803.       pressed on the left third of the textbox, infowindow will be opened.
  804.     · TFMX & TFMX 7c enchancements: position/length, ffwd and rew,
  805.           songend.
  806.     · Sometimes PS3M didn't start to play in killermode (my fault). Fixed.
  807.     · New design in the mainwindow.
  808.     · Amount of files showed in the mainwindow now selectable.
  809.     · Amount of songs (if available) shown after current songnumber.
  810.     · Some samplenameviewer bugs removed.
  811.     · IMPORTANT: Versions 1.30 to 1.33 didn't work on A500 or A600,
  812.       in other words on 68000. This version should work OK.
  813.  
  814. v1.35 (2.1.-95)
  815. ---------------
  816.     · Samplenameviewer still had a bug! Vanquished it!
  817.     · New scope for ProTracker: patternscope.
  818.     · Prefs: doubleclick, center name, some gfx changes,
  819.              multiple choice requesters with RMB.
  820.     · Stringgadgets in prefs will only accept fonts of size 8 or
  821.       smaller. No more trash.
  822.      · Aargh! Stupid LhA command mistake corrected! %s" -> "%s" !
  823.     · ProTracker replayer caused Enforcer hits! Fixed...
  824.     · Modulename shown in the title of the samplenamewindow.
  825.     · Removed that little window when opening LhA, zip and gzip files.
  826.     · ProTracker: Songnumber not shown and NS/PS gadgets disabled
  827.       when there's only one song in module (most modules have only
  828.       one song).
  829.     · Removed the SID scope. It was "illegal" as it used some
  830.           undocumented functions in the playsid.library. 
  831.     · Removed the PT fastram player. It was terrible.
  832.     · TWO SERIOUS BUGS REMOVED! When playing ProTracker modules
  833.           (or alike), my PT replayer and Guru's PS3M sometimes
  834.       scrambled system's memorylist! Aargh (part 2)!!
  835.     · Found more bugs in the PT replayer. I have been using it for
  836.       two years and there's still bugs left... Some effect commands
  837.           weren't played correctly while notedelaying (EEx). Fxd.
  838.     · Player v6.1A: Stop/cont working again. 
  839.  
  840. v1.38 (9.1.1995)
  841. ----------------
  842.     · Oktalyzer modules played wrong on non-50Hz screens. Fixed.
  843.     · One TFMX 7c interface bug removed.
  844.     · Added startup play.
  845.     · Added load & play module or program by pressing the function
  846.       keys.
  847.     · No need to have PRG in front of the filename anymore when loading
  848.       programs via commandline.
  849.     · Programs can be loaded with New/Play.
  850.     · File & directoryrequesters use the font defined in system's prefs.
  851.     · Fixed one bug in PS3M (divide by zero-exception when playing S3Ms).
  852.  
  853. v1.39 (12.1.1995)
  854. -----------------
  855.     · Quick bug fix! Damn I'm stupid! v1.38 doesn't work on 68000,
  856.       this version does.
  857.     · The mainwindow is now an AppWindow! Now you can drop modules and
  858.       moduleprograms on the window and they get loaded and played.
  859.       This feature is for kick2.0+ only.
  860.  
  861. v1.40 (21.1.1995)
  862. -----------------
  863.     · The terrible fastramplayer is back. Works somehow.
  864.     · Prefs: Show modulename in titlebar, set playing time (timeout).
  865.     · Works better with arc-handler (ARC:).
  866.     · Killed a killer bug in the PT replayer.
  867.     · LhA enchancement: Load both TFMX mdat and smpl files from one
  868.       archive.
  869.     
  870.  
  871. **********
  872. * Thanks * 
  873. **********
  874. Jarno Paananen (Guru/Sahara Surfers)
  875. - Hi friend! Thanks very much for the PS3M!
  876.  
  877. Nico François
  878. - For the great reqtools.library!
  879.  
  880. Per Håkan Sundell & Ron Birk
  881. - For making almost perfect SID emulation!
  882.  
  883. In no order:
  884. ------------
  885. Kari out of Bitmans
  886. Jani Päijänen
  887. Kimmo Tokkari
  888. Arto Ikola
  889. Aki Laukkanen
  890. Fredrik Andersson
  891. Morten Wilken Rasmussen
  892. Zdenek Kabelac
  893. Paul Petershagen
  894. Thomas Schuerger
  895.  
  896.  
  897. *********
  898. * About * 
  899. *********
  900. The  program  was  made  by using Asm-Ones v1.06/1.09/1.25.  Pure assembler
  901. 100%+++.  Sourcecode length without any playroutines about 215kb.
  902.  
  903. Bug  reports,  comments  &  suggestions,  moduleswapping and C-64 wares are
  904. welcome!
  905.  
  906.   Kari-Pekka Koljonen
  907.   Torikatu 31
  908.   40900 Säynätsalo
  909.   Finland
  910.  
  911.  E-mail: kpkoljon@freenet.hut.fi
  912.  Finns phone: 941-3742699
  913.